home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / Libraries / Tools Plus 2.5.1 / Read Me First! next >
Encoding:
Text File  |  1994-12-04  |  12.6 KB  |  279 lines  |  [TEXT/ttxt]

  1.  
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.     FOR BEST RESULTS, OPEN THIS DOCUMENT USING A WORD PROCESSOR
  4.     AND DISPLAY IT USING A MONOSPACED FONT, SUCH AS MONACO 9.
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7.  
  8.  
  9. What is “Tools Plus”
  10. ````````````````````
  11.   Tools Plus is a set of powerful, yet easy-to-learn productivity libraries for Macintosh programmers using Symantec Corporation’s THINK C/C++, and THINK Pascal.  Over 170 high-powered “set and forget” routines let you create your application’s user interface, while Tools Plus maintains it for you and takes care of event management.
  12.  
  13.   With Tools Plus, you have the advantage of enhanced functionality, automation, and full integration of: windows, floating palettes, tool bar, cursors, buttons, picture buttons, scroll bars, editing fields, list boxes, pull-down and hierarchical menus, pop-up menus, the Edit menu, clipboard, alerts, event handling, and more.  Once you create your user interface, Tools Plus makes it work.  Virtually all Tools Plus routines can be executed with a single line of code.
  14.  
  15.   Using Tools Plus simplifies your programming and accelerates development.  You’ll create applications in less time, with less source code, with far fewer bugs, and with more features than if you use ordinary C/C++ or Pascal.
  16.  
  17.   Tools Plus libraries can be compiled into applications intended for System 5 and 6 (running under Finder and MultiFinder™), and System 7.
  18.  
  19.  
  20.   Tools Plus is explained in greater detail in chapter 1 (Introduction) of the User Manual.  For a summarized list of benefits and features, please refer to the following documents:
  21.       Read Me! Advantage Tools Plus
  22.       Read Me! Key Features
  23.  
  24.  
  25.  
  26. If you decide to register Tools Plus, you will receive:
  27.    √ the latest version of Tools Plus
  28.    √ a comprehensive, illustrated 250-page user manual
  29.    √ free technical support
  30.    √ free software updates
  31.    √ software upgrades at reduced prices
  32. and you may distribute programs created with Tools Plus royalty-free.
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. MINIMUM Requirements to Develop Applications using Tools Plus
  40. `````````````````````````````````````````````````````````````
  41. • Macintosh Plus computer
  42. • System 6.0.4 
  43. • THINK C 5.0.1 or later         or
  44.   Symantec C/C++ 6.0.1 or later  or
  45.   Symantec C/C++ 7.0 or later    or
  46.   THINK Pascal 4.0.2 or later
  47. • 1 MB RAM (2 MB with System 7)
  48. • Hard disk (for THINK C/C++ or THINK Pascal)
  49.  
  50.  
  51.  
  52.  
  53. MINIMUM Requirements to Run Applications Written With Tools Plus
  54. ````````````````````````````````````````````````````````````````
  55. • Macintosh 512KE computer
  56. • System 5.0*
  57. • 64K RAM (for application)
  58. • Floppy disk drive
  59.  
  60. *Tools Plus takes advantage of System 7’s features, but you can
  61.  compile Tools Plus libraries into applications intended to run
  62.  on System 5, 6 or System 7.
  63.  
  64.  
  65.  
  66.  
  67.  
  68. Shareware
  69. `````````
  70. This fully featured copy of Tools Plus is distributed at no cost as Shareware.  The purpose of this is to allow potential users to EVALUATE the software before buying it.  There are, however, terms and conditions to using this product, even for the purpose of evaluation.
  71.  
  72.   Tools Plus is also available as a “fully registered” product for a registration fee.  Registration entitles you to special privileges and benefits that are not offered to unregistered users.
  73.  
  74.   For full details, please read the “ShareWare License & Legal Info” document.
  75.  
  76.  
  77.  
  78.  
  79.  
  80. What Is Shareware?
  81. ``````````````````
  82.   “Shareware” is a method of software distribution that gives users an opportunity to try software before buying it.  If you try a Shareware program and continue using it, you are expected to register.  Details vary for individual programs: some request registration while others require it.  Some specify a maximum trial period.  With registration, you get anything from the simple right to continue using the software, to an updated program with printed manual.
  83.  
  84.   Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights with a few specific exceptions as specifically stated.  Like commercial authors, Shareware authors are accomplished programmers, and their programs are of comparable quality (in both cases, there are good programs and not-so-good programs).  The main difference is in the method of distribution. The Shareware author specifically grants the right to copy and distribute the software, either to anyone or to a specific group.  Some authors, for example, require written permission before a commercial disk vendor may copy their software.
  85.  
  86.   Shareware is a method of distribution, not a type of software. You should always buy software that suits your requirements and budget, regardless if it’s commercial or Shareware.  The Shareware system makes it easier to determine if the software suits your needs, because you can try it before you buy it.  Furthermore, since the Shareware author’s overhead is low, prices are generally low as well.  Shareware has the ultimate money-back guarantee: if you don’t use the product, you don’t pay for it!
  87.  
  88.  
  89.  
  90.  
  91.  
  92. Tools Plus Documentation
  93. ````````````````````````
  94.   The “evaluation” documentation that is included with this copy of Tools Plus is extensive, but well organized and easy to follow.  It has, however, been edited to (a) reduce its size to facilitate electronic transfer, and (b) to allows users to read the files regardless of their brand and version of word processor.  As a result, this documentation does not include, pictures, illustrations, programming tips, or an index.  If you choose to register your copy of Tools Plus, you will receive a comprehensive 250 page professionally illustrated, indexed and bound Tools Plus User Manual.
  95.  
  96.   For the best viewing results, please open the Tools Plus documentation by first launching your word processor, then use the File menu’s Open command to open the desired document.  Display the document using a monospaced font (Monaco 9pt is recommended).  As a last resort, if you do not have a word processor, you can double-click any of the documents and TeachText (a free application from Apple that comes with each set of System disks) will display them.
  97.  
  98.  
  99.  
  100.  
  101.  
  102. Tools Plus Documentation - Chapters
  103. ```````````````````````````````````
  104.   The Tools Plus User Manual can be found as a number of documents in the “User Manual” folder.  Each document in the “User Manual” folder is a single chapter of the User Manual.  If you view the folder by name, you will see the documents sorted by chapter number (because the document’s name starts with the chapter number).
  105.   TeachText has a file limit of 32k (as do some low-end text processors), so chapters that exceed that limit have been split into several files (suffixed with “1 of 2” and “2 of 2” etc.)
  106.   The following is a summary of the User Manual’s chapters:
  107.  
  108.   “ShareWare License & Legal Info”
  109.        • Copyright and trademark information
  110.        • An explanation of Shareware
  111.        • Software License and Warranty
  112.        • Registration information
  113.  
  114.   “00-Contents”
  115.        • User Manual’s table of contents
  116.  
  117.   “01-Introduction”
  118.        • What is Tools Plus
  119.        • An Overview of Tools Plus
  120.        • The advantages of using Tools Plus
  121.        • Who can benefit from Tools Plus
  122.        • What kind of applications can be written with Tools Plus
  123.        • What is Tools Plus not suitable for
  124.        • System Requirements (computer, system, memory, disk, etc.)
  125.        • Tools Plus Source Code and Site Licensing
  126.        • Before You Start Programming
  127.        • If you are new to Macintosh programming
  128.  
  129.   “02-Installing Tools Plus”
  130.        • Installation instructions describing how to install Tools Plus
  131.          in your THINK C/C++ project, or THINK Pascal project.
  132.        • How to compile the demo application included with Tools Plus
  133.  
  134.   “03-Designing Your Application”
  135.        • How to design your application to work with Tools Plus
  136.        • Overview of Macintosh events vs Tools Plus events
  137.        • The main event loop
  138.        • Differences in Finder, MultiFinder and System 7
  139.  
  140.   “04-Initializing Tools Plus”
  141.        • How to initialize the Tools Plus libraries before using them
  142.  
  143.   “05-Windows (1 of 3)”
  144.   “05-Windows (2 of 3)”
  145.   “05-Windows (3 of 3)”
  146.        • Explanation of windows’ features
  147.        • Creating and using windows in your application
  148.        • Creating and using a tool bar in your application
  149.        • Creating and using floating palettes in your application
  150.  
  151.   “06-Buttons”
  152.        • Explanation of buttons’ features
  153.        • Creating and using buttons in your application (includes push-
  154.          buttons, radio buttons and check-boxes)
  155.  
  156.   “07-Picture Buttons (1 of 3)”
  157.   “07-Picture Buttons (2 of 3)”
  158.   “07-Picture Buttons (3 of 3)”
  159.        • Explanation of picture buttons’ features
  160.        • Creating and using picture buttons in your application
  161.  
  162.   “08-Scroll Bars”
  163.        • Explanation of scroll bars’ features
  164.        • Creating and using scroll bars in your application
  165.  
  166.   “09-Editing Fields (1 of 2)”
  167.   “09-Editing Fields (2 of 2)”
  168.        • Explanation of editing fields’ features
  169.        • Creating and using editing fields in your application
  170.  
  171.   “10-List Boxes”
  172.        • Explanation of list boxes’ features
  173.        • Creating and using list boxes in your application
  174.  
  175.   “11-Pop-Up Menus (1 of 2)”
  176.   “11-Pop-Up Menus (2 of 2)”
  177.        • Explanation of pop-up menu’ features
  178.        • Creating and using pop-up menus in your application
  179.  
  180.   “12-Menus (1 of 2)”
  181.   “12-Menus (2 of 2)”
  182.        • Explanation of menus’ features
  183.        • Creating and using pull-down menus in your application
  184.        • Creating and using hierarchical menus in your application
  185.  
  186.   “13-Cursors”
  187.        • Explanation of cursor features
  188.        • Automatic cursor changes (cursor tables and zones)
  189.        • Cursor animation
  190.        • Creating and using cursors in your application
  191.  
  192.   “14-System Polling (1 of 4)”
  193.   “14-System Polling (2 of 4)”
  194.   “14-System Polling (3 of 4)”
  195.   “14-System Polling (4 of 4)”
  196.        • Explanation of Tools Plus’s automatic processes
  197.        • Polling for events (the main event loop)
  198.        • Tools Plus events vs Macintosh Toolbox events
  199.        • Responding to Tools Plus events
  200.  
  201.   “15-Color Drawing/Multi Screens”
  202.        • Programming for Macs that have several monitors
  203.        • Color-dependent drawing (drawing that changes depending on the
  204.          monitor’s settings, such as: [1] color, gray or B&W, [2] number
  205.          of colors or grays)
  206.  
  207.   “16-User Notification”
  208.        • Explanation of User Notification features
  209.        • Setting and triggering User Notification in your application
  210.  
  211.   “17-Dynamic Alerts”
  212.        • Explanation of Dynamic Alerts’ features
  213.        • Creating and using Dynamic Alerts in your application
  214.  
  215.   “18-Miscellaneous Routines”
  216.        • Several Macro routines that perform commonly used tasks, such
  217.          as drawing icon families, drawing “zoom lines”, and drawing the
  218.          standard progress thermometer.
  219.  
  220.   “19-Other Macintosh Features”
  221.        • Creating and using the Macintosh toolbox’s alerts and dialogs,
  222.          custom controls, and list manager.
  223.  
  224.   “20-Memory”
  225.        • List of Tools Plus routines that consume memory, and details as
  226.          to how much memory.
  227.  
  228.   “21-Font Heights”
  229.        • List of commonly used fonts and their heights
  230.  
  231.   “22-Special Routines”
  232.        • Macintosh toolbox routines that should be used with caution or
  233.          not at all.
  234.        • Substitute Tools Plus routines are listed where the toolbox’s
  235.          routines should not be used.
  236.  
  237.   “23-Completing Your Application”
  238.        • Finishing touches needed to complete an application written
  239.          with Tools Plus.  Most of this is similar to ordinary Macintosh
  240.          applications (i.e. the SIZE resource, the application’s icon
  241.          family, the BNDL resource, etc.)
  242.  
  243.   “24-Technical Support & Updates”
  244.        • How Water’s Edge Software technical support can help you
  245.        • Free software updates and upgrades
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252. P L E A S E   R E A D ....
  253. ``````````````````````````
  254. Please read the “ShareWare License & Legal Info” document.  It grants you to specific rights, and defines the limits of use of this Shareware software.
  255.    Also, please read the User Manual (“glancing” through it doesn’t count).
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Feedback
  262. ````````
  263. In the interest of providing you with the best possible product, we invite you to tell us your opinions about Tools Plus... even if you are not a registered user.
  264.    Tell us what you like, what you don’t like, and let us know what features you would like to see in future releases.  Please send your feedback to the CompuServe address listed below: 
  265.  
  266.    73424,2507
  267.  
  268. If you are using AppleLink or another e-mail system, you likely have access to Internet.  Water’s Edge Software can be contacted at the following Internet account:
  269.  
  270.    73424.2507@compuserve.com
  271.  
  272. Please check your e-mail User Manual, or contact your e-mail Customer Service representative for information on accessing Internet accounts.
  273.  
  274.  
  275.  
  276.  
  277.  
  278. E N J O Y !
  279.